home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / l11.zip / L.DOC < prev    next >
Text File  |  1993-05-06  |  24KB  |  480 lines
  1.  
  2.  
  3.                                     #      
  4.                                     #      
  5.                                     #      
  6.                                     #      
  7.                                     #      
  8.                                     #      
  9.                                     #######
  10.  
  11.  
  12.  
  13.  
  14. You can get part of the following documentation by invoking the program with
  15. the switches -v, -h, or -H . See README.TXT for more information.
  16.  
  17. -----------------------------------   -v   ------------------------------------
  18. L v1.1 -- Display information about files and directories
  19. Copr (c) 1988-1993 Albert Ramm & Richard Breuer. L is freeware. No warranties.
  20.  
  21. This is L/2 v1.1 - renamed to L (from RUTILS 4).
  22.  
  23. Layout and portions of the code:
  24.         Albert Ramm
  25.         Konrad-Adenauer-Strasse 77
  26.         5190 Stolberg/Büsbach
  27.         Germany, Europe
  28. Phone:  +49/2402/91054
  29.  
  30. Re-Implementation and enhancements:
  31.         Richard Breuer
  32.         Brunssumstrasse 6
  33.         5100 Aachen
  34.         (after Jul 1, 1993: 52074 Aachen)
  35.         Germany, Europe
  36. Phone:  +49/241/85605
  37. Fax:    +49/241/8021329
  38. Email:  ricki@pool.informatik.rwth-aachen.de (Preferred!)
  39.  
  40. -----------------------------------   -h   ------------------------------------
  41. L v1.1 -- Display information about files and directories
  42. Copr (c) 1988-1993 Albert Ramm & Richard Breuer. L is freeware. No warranties.
  43.  
  44. Usage:
  45.    L [-12458adefhHkKmnp:rRsuxvV] directory.. filename.. [{>|>>} outfile]
  46.  
  47. Options (default is L -kn):
  48.    -5,-1,-2,-4,-8  Round file sizes by 512, 1024, 2048, 4096, or 8192 bytes
  49.    -d,-e,-n,-s,-u  Sort by date, extension, name (default), size, or nothing
  50.    -a              Additionally mark files whose attribute flag is set
  51.    -f           Display full information (with size, date, and time)
  52.    -h             Display this help screen
  53.    -H             Display another help screen with notes and examples
  54.    -k,-K           Use kB (1000 bytes, default) or KB (1024 bytes) to calculate
  55.    -m           Merge files and directory names (default is: dirs first)
  56.    -p[wid]         Force plain text output which can be piped to other programs
  57.                    (wid is an optional output width, default is wid=79)
  58.    -R           Recursivly scan subdirectories and calculate their size
  59.    -r              Reverse the sorting order
  60.    -v              Display version info
  61.    -V              Display hidden files
  62.    -x           Highlight EXE, COM, BAT, and BTM files (VERY USEFUL)
  63.  
  64. -----------------------------------   -H   ------------------------------------
  65. L v1.1 -- Display information about files and directories
  66. Copr (c) 1988-1993 Albert Ramm & Richard Breuer. L is freeware. No warranties.
  67.  
  68. Notes:
  69.    L is a replacement for DOS's DIR command. It is designed to present
  70.    a directory in a much better readable way than DIR. L writes directly
  71.    to the screen, therefore you _might_ have problems with your display. I
  72.    will not work on this until someone actually reports problems.
  73.  
  74. Examples:
  75.    L
  76.       Display the current directory, as DIR.
  77.    L -x
  78.       Highlights (one a color display) the executable files.
  79.    L C:\ D:\ -V
  80.       Display the files in C:\*.* and D:\*.* together, showing hidden files.
  81.    L C:\ -R
  82.       Calculate the overall disk storage used on drive C:.
  83.  
  84.  
  85. -------------------------------------------------------------------------------
  86. History:
  87.    L is derived from the program D.EXE which I used for several years. It has
  88.    been written by Albert Ramm, a long time friend of mine. I recently managed
  89.    to convince him that the public (you!) might be interested in his program.
  90.    He gave me (part of) his source code, and I used it to re-implement most of
  91.    the code using my basic layer. I enhanced the program in several parts, as
  92.    there are
  93.  
  94.         - full support for any display mode, including 80x25, 80x43,
  95.           80x60, 100x60, 132x25, 132x28, 132x48 (these are the modes my
  96.           graphics card supports, but L should work with ANY possible
  97.           mode, as long as there are more than 3 lines and more than
  98.           18 columns)
  99.         - L displays the Volume ID
  100.         - you can use 1000 or 1024 as the base for the calculation of
  101.           file sizes
  102.         - you can specify more than one directory to be displayed. All
  103.           files will be collected, sorted, and displayed as if they were
  104.           in one directory
  105.         - the -r switch reverses the sorting order
  106.         - the -m switch merges files and directories
  107.         - L detects output redirection and switches to ASCII mode, if it
  108.           is used; the -p switch forces this behaviour
  109.  
  110.  
  111. Examples:
  112.   Consider a directory C:\FOO which contains the following files:
  113.  
  114.     dSUBFOO·· ···         02/11/93 13:41:10         a subdirectory
  115.      L······· PAS   21448 02/10/93 22:17:56
  116.      T······· PAS       6 02/11/93 13:25:40
  117.     rMCOL···· PAS    7270 02/10/93 16:09:18         read-only attribute
  118.      STRINGS2 PAS    7384 02/10/93 16:09:22
  119.      TEE····· PAS    4914 02/10/93 16:09:22
  120.      WC······ PAS    5536 02/10/93 16:09:30
  121.     sNC······ PAS    8416 02/10/93 16:09:18         system attribute
  122.     hNODUP··· PAS    4185 02/10/93 16:09:20         hidden attribute
  123.      KEYFAKE· COM     536 09/17/85 12:07:52
  124.      CB······ BAT     409 01/24/93 21:06:00
  125.  
  126.   and the subdirectory SUBFOO shall contain these files:
  127.  
  128.      MCOL···· H1·    1049 01/09/93 12:30:58
  129.      NC······ H1·    1171 01/08/93 22:17:50
  130.      NODUP··· H1·     630 01/08/93 22:18:00
  131.      L······· H1·     970 02/06/93 13:20:06
  132.      STRINGS2 H1·     897 01/25/93 14:15:38
  133.      TEE····· H1·     553 01/08/93 22:16:38
  134.      WC······ H1·     854 01/08/93 22:18:32
  135.  
  136.  
  137.   Invoking L without arguments displays:
  138. -------------------------------------------------------------------------------
  139. Directory of C:\FOO\*.*                                            9605 kB free
  140. 9 Files with a total of 55 kB disk space                            HARDDISK1··
  141. dSUBFOO·· ···        L······· PAS   21   STRINGS2 PAS    7   WC······ PAS    5 
  142.  CB······ BAT  .409 rMCOL···· PAS    7   TEE····· PAS    4  
  143.  KEYFAKE· COM  .536 sNC······ PAS    8   T······· PAS  .006 
  144. -------------------------------------------------------------------------------
  145.  
  146.   Let's discuss the information:
  147.  
  148.   Line #1       contains the name(s) of the displayed directories and the amount
  149.                 of free disk space. You may specify more than one directory when
  150.                 you invoke L. In this case the files and subdirectories are
  151.                 collected and displayed as if they were in one directory. The
  152.                 free disk space is displayed only, if all the directories which
  153.                 are displayed are on the same drive (which is of course true if
  154.                 only one is listed - the normal case)
  155.  
  156.   Line #2       gives information about how many files were collected and how
  157.                 much space they consume. The latter number is divided by 1000,
  158.                 therefore a 0 is displayed if the sum is less than 1000 bytes.
  159.                 Note than the -K switch makes L use 1024 as its calculation
  160.                 base. At the end of Line #2 the volume label is displayed. If
  161.                 the drive has no label, [no vlabel] is displayed. If the command
  162.                 line contains more than one directory from different drives,
  163.                 [multi drv] is displayed.
  164.  
  165.   Lines #3 ff   contain the directory & file list. Directories are always
  166.                 displayed before the files, nomatter which sorting order is
  167.                 chosen (Only the -m switch can merge files and directories
  168.                 together). They are preceded by "d" to mark them as directories.
  169.                 Normally (unless the -R switch is specified), directory names
  170.                 are followed by a blank field, while files are followed by
  171.                 their size. The size is displayed as follows:
  172.  
  173.                         .xxx    if the size is less than 1000 (for -K: 1024
  174.                                 with the special case of 1000<=size<1024,
  175.